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ABSTRACT 


The  Navy  Resource  Model  (NARM)  is  a  system 
of  computer  programs  which  provides  the  capability 
to  cost  a  total  Department  of  the  Navy  program.  At¬ 
tached  to  the  basic  cost  model  are  many  peripheral 
programs  that  serve  important  functions.  This  paper 
focuses  on  the  use  of  one  such  program,  UPDATE. 
UPDATE's  function  is  to  provide  the  NARM  user  with 
a  flexible  method  of  changing  the  data  base.  TTie  fol¬ 
lowing  is  intended  to  be  a  guide  for  the  new  or  casual 
user  as  well  as  a  reference  for  the  experienced  user. 
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INTRODUCTION 


Program  UPDATE  provides  a  method  for  altering  cost  factor  inputs  to  the  Navy  Re¬ 
source  Model  (NARM).  The  purpose  of  this  guide  is  to  give  the  user  a  detailed  reference 
to  the  program’s  operating  features  and  its  application.  The  text  that  follows  requires 
only  that  the  user  be  familiar  with  the  basic  concepts  of  the  NARM  as  described  in  the 
Users  Guide  to  the  Report  Generator. 

METHODS  OF  ALTERING  INPUT  FILE 

The  working  file  of  the  NARM  is  composed  of  Program  Unit-Program  Element 
(PU-PE)  sequence  rows.  Within  each  row  there  are  presently  12  positions  corresponding 
to  the  12  years  represented  on  the  file.  Program  UPDATE  allows  the  user  to  change 
these  rows  in  five  different  ways: 

1)  Deletions 

2)  Changes 

3)  Algebraic  Additions 

4)  Percentage  Adjustments 

5)  Substitutions  or  Insertions 

A  description  of  each  of  these  forms  follows.  It  is  suggested  that  the  reader  examine 
sample  update  cards  displayed  in  figure  1  for  a  general  view  of  the  card  layout. 

Deletions  permit  the  elimination  of  sequence  rows.  A  maximum  of  100  deletions 
are  permitted.  In  cases  that  exceed  this  limit  the  first  100  deletions  will  be  made,  and 
a  diagnostic  will  appear  showing  the  overflow. 

Changes  allow  for  a  correction  to  particular  year(s)  of  the  PU-PE  sequence  row.  The 
value  on  the  update  card  will  be  substituted  in  the  appropriate  year  on  the  file.  Only  years 
with  non -blank  entries  on  the  update  card  will  be  changed  on  the  file.  Zeroes  in  the  cor¬ 
rect  fields  will  change  the  year  to  a  zero  value  while  blanks  will  leave  the  year  unchanged. 

Algebraic  Additions  are  similar  to  changes.  Additions  will  allow  the  user  to  add  the 
data  for  a  particular  year  on  the  update  card  to  the  corresponding  row  year  on  the  file. 
Blanks  in  this  case  are  treated  as  zeroes.  Negative  signs  may  also  be  employed.  The 
number  of  changes  and  additions  in  the  update  run  must  not  exceed  750.  In  cases  that  ex¬ 
ceed  the  maximum,  the  first  750  will  be  processed,  and  the  overflow  noted  in  a  diagnostic. 

Percentage  Adjustments  will  allow  sequence  rows  to  be  altered  by  a  multiplicative 
factor.  The  factor  may  be  applied  to  all  or  one  particular  year  of  the  row.  TTie  program 
is  capable  of  handling  as  many  as  100  percentage  adjustments. 
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FIG.  1:  SAMPLE  UPDATE  CARDS 


Substitutions  or  Insertions  allow  for  the  replacement  of  tin  entire  PU-PE  sequence 
row  by  an  update  card.  If  the  row  doesn’t  already  exist  on  the  old  file,  the  program  will 
insert  the  data  in  its  proper  place. 

For  Deletions,  Percentage  Adjustments,  and  Insertions,  the  sequence  rows  can  be 
updated  by  logical  key.  In  other  words,  if  only  a  few  of  the  keys  are  designated  with 
values  on  the  update  card  with  the  remaining  keys  left  blank,  all  PU-PE  sequence  rows 
that  have  matching  key  values  for  the  keys  designated  will  be  updated  regardless  of  the 
value  of  the  remaining  keys.  The  other  update  forms  require  the  full  PU-PE  sequence 
values.  In  most  instances,  however,  the  PE  is  zero.  It  is  non-zero  only  for  forces 
and  program  related  factors,  such  as  aircraft  manning  factors. 

Sequence  rows  can  be  manipulated  by  more  than  one  update  card  within  a  run.  The 
execution  order  of  the  update  forms  is  exactly  the  order  presented  in  the  description 
above.  The  user  must  be  careful  to  take  note  of  the  execution  order  to  obtain  the  desired 
result. 

PROGRAM  EXECUTION 

The  operation  of  UPDATE  requires  the  job  set-up  illustrated  in  figure  2.  A  general 
description  of  the  cards  is  presented  in  table  1  in  the  order  of  placement  within  the  data 
deck.  Figure  3  displays  a  sample  input  card  deck  that  results  in  the  program  output 
shown  in  figure  4.  A  description  of  the  more  important  parameters  and  operations  of  the 
model  follows. 

The  update  control  card  defines  the  scope  of  the  update.  It  informs  the  program  of 
the  location  of  the  update  data,  the  number  of  years  to  be  worked  with,  and  the  forms  of 
updates  that  will  be  used.  Particularly,  flags  must  be  set  if  percentage  factor  adjustments 
are  included  in  the  run  or  insertions  are  to  be  updated  by  logical  key.  The  replacement 
data  sort  feature  simply  allows  the  program  to  forgo  sorting  the  input  update  data  if  it  is 
presorted. 

The  logical  units  of  the  tapes  involved  are  preset  by  the  program.  Unit  1  is  reserved 
for  the  input  WDATA  tape.  Unit  2  holds  the  output  (updated)  WDATA  tape.  Unit  3  is  used 
for  the  update  card  images  if  they  are  stored  on  tape.  Unit  4  is  reserved  for  the  Program 
Element  -  Mission  Category  (PE-MC)  Dictionary.  Finally,  logical  unit  69  holds  the  program 
load -and -go  tape. 

The  dictionary  to  be  placed  on  LU  4  is  required  for  all  runs.  Its  purpose  is  to  provide 
the  WDATA  file  with  the  correct  key  9  values.  Due  to  the  lack  of  space  on  the  update  card 
for  the  nine  key  values  of  the  PU-PE  codes,  another  method  for  updating  this  key  was  needed. 
Because  the  program  element  is  associated  uniquely  with  a  mission  category,  a  PE-MC 
dictionary  is  used.  Dictionary  maintenance  should  occur  with  every  new  Report  Generator 
PE  dictionary  sent  from  OP-904.  Their  dictionary  contains  the  mission  category  in  col¬ 
umns  73  and  74.  Because  our  Report  Generator  dictionaries  are  stored  on  Macrosim  tapes, 
and  Macrosim  uses  columns  73-80  for  card  sequencing,  a  separate  PE-MC  has  to  be  con¬ 
structed  from  their  PE  dictionary.  The  Generalized  Extract  Program  is  ideally  suited  for 
this  purpose.  A  sample  of  the  PE-MC  dictionary  and  the  job  set-up  for  its  construction  are 
found  in  appendix  A. 
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TABLE  1 


DESCRIPTION  OF  CARDS 
Columns  Format_ Description 

UPDATE  CONTROL  CARD  (Required) 


1-2 

12 

Logical  unit  of  update  data 
=  60:  card  reader 
=  03:  tape 

=  blank:  default  to  card  reader 

3-4 

12 

Number  of  years  on  old  master  WDATA  file  (Currently 

5-6 

12 

Number  of  years  on  updated  master  WDATA  file 
(Currently  11) 

6 

11 

Print  options 

=  blank  or  0:  no  print 
*  1:  ships  only 
=  2:  aircraft  only 
=  3:  ships  and  aircraft 
=  5:  thru  put  only 
=  6:  ships,  aircraft,  and  thruput 
=  7:  variable  support  only 
=  9:  everything 

8 

11 

Print  of  update  data 

=  blank  or  0:  printed 
=  1:  not  printed 

9 

11 

Replacement  data  sort 
=  0:  sorted 
=  1:  not  sorted 

10 

11 

Percentage  Factor  Adjustments 
=  blank  or  0:  option  not  used 
=  1:  option  used. 

11-14 

14 

First  year  on  WDATA  tape.  Default  to  1971. 

15 

11 

Logical  Key  Replacements 
=  0:  option  not  used 

=  1:  option  used 
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Columns 


Format 


Description 


PERCENTAGE  FACTOR  CARDS  (Optional) 
(Maximum:  100  cards) 


1-2 

2X 

Card  identification  or  blank 

3 

11 

Key  1  value 

4 

11 

Key  2  value 

5-6 

12 

Key  3  value  (key  values  may  be  left  blank) 

7-8 

12 

Key  4  value 

9-10 

12 

Key  5  value 

11-15 

5X 

Blank  or  identification 

16-20 

15 

Sequence  number 

21-23 

3X 

Blank  or  identification 

24-25 

12 

Year  (1-12)  of  WDATA  to  adjust 

=  blank:  adjust  all  years 

26  -  35 

F10.0 

Multiplicative  factor 

Last  card  of  set 

1-2 

A2 

**Signals  end  of  percentage  adjustments 
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Columns 


Format 


Description 


REPLACEMENTS  BY  LOGICAL  KEY 


1 

11 

Key  1  value 

2 

11 

Key  2  value 

3-4 

12 

Key  3  value  (keys  may  be  left  blank) 

5-6 

12 

Key  4  value 

7-8 

12 

Key  5  value 

9-16 

8X 

Blank  or  identification 

17-19 

13 

Sequence  row 

20 

11 

Spread  code 

=  1:  detain  first  year  spread  to  all  years 
=  blank  or  zero:  data  not  spread 

21-25 

Integer  or 

fixed  first  year  data 

26-30 

Integer  or 

fixed  second  year  data  (spread  code  not  equal  to  1) 

31-35 

Integer  or 

fixed  third  year  data  (spread  code  not  equal  to  1) 

75-80  Integer  or  fixed  twelfth  year  data  (spread  code  not  equal  to  1) 


Last  card  of  set:  End  of  File  is  used  to  signal  end  of  logical  key  update  cards. 
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Columns 

Format 

Description 

DELETIONS 
(Maximum:  100  cards) 

1 

11 

Key  1  value 

2 

11 

Key  2  value 

3-4 

12 

Key  3  value  (keys  may  be  left  blank) 

5-6 

12 

Key  4  value 

7-8 

12 

Key  5  value 

9 

A1 

Update  code 

=  D:  deletion 

10-16 

16 

Program  element  (may  be  blank) 

17-19 

13 

Sequence  row 

=  value:  will  delete  only  those  sequence  rows 
=  blank:  delete  all  sequence  rows 

20-80 

Blank 
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Columns 

Format 

Description 

CHANGES, 

ADDITIONS,  REPLACEMENTS,  INSERTIONS 

1-8 

18 

Program  unit  code 

9 

Al 

Update  code 

=  Blank:  Insertion  or  Replacement 
=  A:  Algebraic  Addition 
=  C :  Change 

10-16 

16 

Program  element 

17-19 

13 

Sequence  row 

20 

11 

Spread  code 

=  1:  data  in  first  year  spread  to  all  years 
=  blank  or  zero:  data  not  spread 

21-25 

Integer  or  fixed  first  year  data 

26-30 

• 

» 

Integer  or  fixed  second  year  data  (spread  code  not  equal  to  1) 

• 

• 

• 

75-80 

« 

• 

Integer  or  fixed  twelfth  year  data  (spread  code  not  equal  to  1) 

JOB, INS130|SASSER,15,500C,P 

fcQUJP,iMWDn-5F),RO 

EQU I P f 2* J MEW  WDATA)#DA 

EQU!P»4*^PEMC  0 ICT ) » RO 

E0U!P#69«(tUPDATE),R0 

LOAD 

RUN, 15, 5000 
6011111  1  1 


PU1 

11 

1.5 

PU22  04 

3 

4 

.5 

** 

1  05 

41 

6 

11 

31 

5 

11050125 

51 

7 

11021405 

331 

2 

1  02 

321 

50 

05 

361 

25 

02  241412 

11 

3 

11020405A241412 

11 

15 

11040608  242312 

11 

6 

11030405C 

12 

-It 

3 

110483050 

18 

FIG.  3:  ILLUSTRATIVE  INPUT 
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UPDATE  RUN 


03/12/71 


Input  oata  on  i.u  so 

U  YEARS  OF  n»TA  ON  WOATA  INPUT  FILE 
11  YEARS  OF  oata  on  wOATA  output  file 

RU  TYPE  i  TO  BE  PRINTED 

Table  of  factor  data 

PU  SEQUENCE  YEAR  FACTOR 

10*0*0*0  11  0  1.500 

22*0  4*0  1  4  0.500 


data  to  be 

UPOaTEC 

l  BY  1 

LOGICAL  KEY 

1  05 

-9 

*  I 

6.00 

-0.00 

11 

-9 

3  1 

5.00 

*0.00 

11050125 

-0 

5  1 

7.00 

•0.00 

11021405 

-0 

33  \ 

2.00 

-0.00 

1  02 

•0 

32  1 

So. 00 

-o.oo 

05 

-0 

36  1 

25.00 

•0.00 

02 

241*412 

l  i 

3.00 

-0.00 

•0  •  A  A 

•0*00 

•0.  00 

•0*00 

•  0.0 

-o.oo 

•0*00 

•6  •  oo 

•0*00 

•0.  O' 

*  0  •  a  n 

•0*00 

•  0*00 

-0*  00 

-0.0* 

-0*00 

-o.oo 

•o.oo 

-0.0' 

•  0*00 

•0*00 

•b«  oo 

-o»oo 

-0.0' 

•  0  •  0  A 

•o.oo 

•o.oo 

•o.oo 

•0.0* 

•  0  •  A  A 

•o.oo 

-0.00 

-o.oo 

•O.Of 

UPDATE  OATA 


11020405A  241412 
11030405C  *0 

110403050  .0 


_1  1  15.00 

1 2  n  *1.00 

1 8 


•0.00  >0.00 

3.00  *o. on 


•0.00  -6.00 

0.00  4.20 


-0.00  *0.0 

2.20  1.1 


REPLACEMENT/ » no  UPDATE  OATA 
PU  PE  SEO  DATA 

1104060B  24231200  1  6.00  6.00  6.00  6.00  6.09 


6.00 


6.0 


FIG.  4:  ILLUSTRATIVE  OUTPUT 
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APPENDIX  A 


APPENDIX  A 


CREATION  OF  THE  PE-MC  DICTIONARY 


The  PE-MC  dictionary  used  by  program  UPDATE  is  constructed  from  the  Report 
Generator's  Program  Element  dictionary  sent  to  CNA  from  OP-904.  The  dictionary 
contains  for  each  PE,  a  title  and  a  mission  category  (fiscal  guidance  category).  The 
dictionary  card  layout  is  shown  below. 


Columns 

Description 

1-6 

Program  element 

8-72 

PE  title 

73-74 

Mission  category 

The  Generalized  Extract  Program  (GEP)  can  reformat  this  dictionary  into  a  format 
acceptable  to  UPDATE.  The  new  dictionary  format  is  as  follows: 

Columns 

Description 

1-6 

Program  element 

8-9 

Mission  category 

10-80 

Blank 

The  computer  control  data  deck  used  to  initiate  this  GEP  run  is  displayed  in 

figure  A-l. 
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FIG.  A-l:  GEP  JOB  SET-UP 
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